home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM A / PD-ROM A.iso / Utility / Text / Ultra 1.3 / Ultra 1.3.Doc < prev   
Encoding:
Text File  |  1991-12-28  |  6.8 KB  |  269 lines  |  [TEXT/ttxt]
  1.                "UltraSort version 1.3"
  2.  
  3. by Murray Cohn
  4.  
  5.  
  6.  
  7. Please display this document in Monoco 9 pt or the columns will be 
  8. out of order.  Insert proper headers/footers/margins before 
  9. printing.
  10.  
  11.  
  12. This program will sort textfiles alphabetically, or in the case of
  13.  
  14. lines that have numbers in the first characters of the string, the 
  15. program will sort those lines by the numbers.  Version 1.3 now 
  16. allows sorting from
  17.  
  18. a particular character almost anywhere in the line.  It has some 
  19. decorative color added.  It sorts very quickly using a binary tree 
  20. system.  A progress report
  21.  
  22. shows how many records have been read and have been written to a 
  23. filename
  24.  
  25. of your own choosing.  It will sort 200 records in well under a 
  26. minute.
  27.  
  28.  
  29. REQUIREMENTS.  Read now or suffer later.
  30.  
  31.  
  32. Dissappointedly, versions 1.3 might not run on Mac II's.  It has 
  33. been tested successfully with the 128K rom.  It therefore should 
  34. work both on 512Ke (enhanced) as well as MacPlus.  Until just last 
  35. week, I didn't realize that the compiler would not create useable 
  36. for code for Mac II's; other Macs have not been tested.  If you 
  37. would like to report your results to Compuserve user ID 72707,2144 
  38. in email many people would appreciate the news.
  39.  
  40.  
  41. It works fine on a MAC LC.
  42.  
  43.  
  44. Make a plain text file of your data using your word processor or 
  45. editor
  46.  
  47. (MacWrite is fine) and save as plain text.  Check your manual or a
  48.  
  49. friend if you don't know how to do this.  Any plain text doc will 
  50. work.
  51.  
  52.  
  53. Requirements are:
  54.  
  55.  
  56. A)  You have a carriage return at every line.
  57.  
  58. B)  Every line must never be more than 80 characters long.
  59.  
  60. C)  You must have no empty lines within your list except at the end.
  61.  
  62. D)  Textfiles are to be set up with spaces, not tabs if you are to
  63.  
  64.     sort by a character other than the first character of the line.
  65.  
  66. E)  There must be a final carriage return at the end of the very 
  67.  
  68.     last line.
  69.  
  70.  
  71. Otherwise, this pascal based program gets confused and crashes never 
  72. finding it's desired carriage return. Remember that wordwrap is not 
  73. allowed, carriage returns at the end of every line is required.
  74.  
  75.  
  76. During program run, you may choose a the field to sort by the 
  77. character number on the line.  Normally sorting is done from 
  78. character in position 1, but you may choose to sort from a field 
  79. deep in the middle of the line.  You will be prompted with a brief 
  80. explanation for the character position from which to do the sorting.
  81.  
  82.  
  83. You are protected from yourself...
  84.  
  85.  
  86. ...as far as trying to save the final sorted list on top of the
  87.  
  88. original unsorted "raw" list.  You are also protected from having to
  89.  
  90. worry about duplicating lines.  Go ahead!  Duplicate!  They final
  91.  
  92. sorted file will have only one line for duplicated lines in "raw"
  93.  
  94. input, having eliminated them in memory during sorting.
  95.  
  96.  
  97. BUT UltraSort is not entirely bomb proof.
  98.  
  99.  
  100. You can experiment to see how many you can get away with
  101.  
  102. on your machine BY USING A COPY OF YOUR DATA FILE not the original.
  103.  
  104.  
  105. If you are not sure and don't have time to check for above 
  106. sitiuations, then:
  107.  
  108.  
  109. Make a copy (a good habit for testing stuff).  Use the finder to 
  110. make
  111.  
  112. a your test copy.  I am supplying a list of Colorado BBS's as a way
  113.  
  114. for you to experience this program functioning ok. (Thanks to Col.
  115.  
  116. Cool Cat, a user of SCCORE BBS)
  117.  
  118.  
  119.  
  120. Run this program on the COPY of your data, not the original.
  121.  
  122.  
  123.  
  124. **EXAMPLE**
  125.  
  126.  
  127. First few lines of "RAW" INPUT DATA (you can see it's sorted by 
  128. number
  129.  
  130. but not by name which we will do with UltraSort)
  131.  
  132.  
  133. Maximum Security                    303-232-5977
  134.  
  135. Lucky Seven                         303-232-6239 12
  136.  
  137. Fred's BBS                          303-233-1316 24
  138.  
  139. Microlink D                         303-237-8575 96
  140.  
  141. Den of Iniquity                     303-238-5750 24
  142.  
  143. BatCave                             303-252-0735 12
  144.  
  145. 8th Sea, The                        303-252-9235 24
  146.  
  147. ...
  148.  
  149.  
  150. Run the program, choose the BBSRAWNUM file as input, use the default 
  151. name SORTED.TXT as the output file, and enter "1" when prompted 
  152. "which character to sort from, since the names all begin with the 
  153. first character on the line.
  154.  
  155.  
  156.  
  157. First few lines of "SORTED.TXT" OUTPUT DATA after above
  158.  
  159. is sorted by UltraSort.
  160.  
  161.  
  162.    Notice alphabetical listing on left, and that
  163.  
  164.    numbers like "8th" come before the latter "A" after sorting.  
  165. (Now
  166.  
  167.    the numbers on the right are obviously no longer in order.)
  168.  
  169.  
  170.  
  171. 8th Sea, The                        303-252-9235 24
  172.  
  173. Aces High                           303-366-8159 24
  174.  
  175. Adelante                            303-443-8292 24
  176.  
  177. Albequerque Starport, The           303-499-6974 12
  178.  
  179. Arvada 68k BBS                      303-424-9831 24
  180.  
  181. Assasin's Guild                     303-722-6881
  182.  
  183. Atari Club BBS                      303-343-2956 24
  184.  
  185. Aurora Chairman                     303-340-1844 12
  186.  
  187. 12345678901234567890123456789012345678901 <--I wrote this for easy
  188.  
  189.                                            counting.  Use Monoco 
  190. Font for
  191.  
  192.                                            even counting and even 
  193. columns.
  194.  
  195.  
  196. The first character on a line is character "1" not character "0" for 
  197. UltraSort's counting purposes.
  198.  
  199.  
  200.  
  201. Sometimes you would want to keep both versions of the files and it 
  202. is 
  203.  
  204. for this reason that the program won't allow you to erase the 
  205. original
  206.  
  207. "raw" data (by naming input and output files as the same).
  208.  
  209.  
  210. To "sort by" a character other than "1"
  211.  
  212.  
  213. At this point you could sort on the 37th character by the area 
  214. codes, or else since all area codes are the same, you could sort by 
  215. the 41st character.  "Sort by..." means just the starting postion to 
  216. sort, all remaining characters are also used up till the end of the 
  217. line.  This time you are using "SORTED.TXT' as the input file so you 
  218. need yet another name for yet another output file.  The result after 
  219. sorting by the 37th or 41st character will produce a file just like 
  220. BBSRAWNUM from which you started.  There may be a few "stray" 
  221. carriage returns at the bottom.
  222.  
  223.  
  224. Use monofonts like Monoco to display all files listed in columns to 
  225. keep all columns lined up evenly and to make character counting 
  226. easier.  UltraSort does not manage files set up with tabs very well 
  227. (unless you are sorting from the first character).
  228.  
  229.  
  230. DISCLAIMER:
  231.  
  232.  
  233. I hate to add this, but due to a small number of people,
  234.  
  235. I have to add that I can't be responsible for your own mistakes.
  236.  
  237. This program is tested.  As long as you followed these instructions
  238.  
  239. you will be fine.  If I had done much more error-trapping, this 
  240. program
  241.  
  242. would not be affordable for you.  It had no viruses at the time of
  243.  
  244. distribution.  The program will not harm any of your programs or 
  245. hardware.  It is very safe.
  246.  
  247.  
  248. THE FUTURE:
  249.  
  250.  
  251. Improvements from demo ver 1.0 to ver 1.3.
  252.  
  253.  
  254. I apologize for inconveniences that were caused in older versions.  
  255. Color is now added; and the sorting feature which allows you to sort 
  256. on a character other than the first character in a line--is now.
  257.  
  258.  
  259. Registration Fee is $15.00
  260.  
  261.  
  262. Murray Cohn
  263.  
  264. 3550 S. Pennsylvania St. #308
  265.  
  266. Englewood, CO  80110
  267.  
  268.  
  269.